Метод IConnector::OpenConfiguration

Открывает конфигурацию.

IDL

[id(102214)]
HRESULT OpenConfiguration(
    [in] IConfiguration* Configuration, 
    [in] AuthenticationModeEnum AuthenticationMode, 
    [in, optional] VARIANT UserName, 
    [in, optional] VARIANT UserPassword, 
    [out, retval] VARIANT_BOOL* Value
);

Параметры

Параметры	Описание
Configuration	Объект конфигурации
AuthenticationMode	Режим авторизации
UserName	Имя пользователя
UserPassword	Пароль
Value	Возвращаемое значение

Возвращаемое значение

"True", если открытие конфигурации прошло успешно.

Описание

Открывает конфигурацию (IConfiguration) и делает ее текущей (IConnector::CurrentConfiguration) по следующему алгоритму:

№	Описание
1.	Закрывает текущую конфигурацию, если какая-либо конфигурация уже открыта.
2.	Генерирует событие IConnectorEvents::OnBeforeOpenConfiguration.
3.	Открывает конфигурацию.
4.	Выполняет авторизацию пользователя.
5.	Генерирует событие IConnectorEvents::OnAfterOpenConfiguration.

Закрытие текущей конфигурации

Если уже была открыта какая-либо конфигурация, сначала для нее выполняет метод IConnector::CloseConfiguration, и лишь при успешном его завершении выполняет открытие новой конфигурации.

Генерация события IConnectorEvents::OnBeforeOpenConfiguration

Перед открытием конфигурации генерирует событие IConnectorEvents::OnBeforeOpenConfiguration, которое может отменить открытие конфигурации.

Авторизация пользователя

Возможны два режима авторизации: серверная авторизация и Windows-авторизация. Windows-авторизация применяется только в том случае, если этот режим авторизации поддерживается используемой СУБД. При Windows-авторизации имя пользователя и пароль игнорируются.

В случае серверной авторизации, после открытия конфигурации выполняется проверка пользователя и пароля (в случае неуспешной авторизации, генерируется ошибка). На данном этапе, если срок действия пароля истек, автоматически генерируется событие обязательного изменения пароля IConnectorEvents::OnUserPasswordExpired (в соответствии с настройками пользователя). Если пароль обновлен, генерируется новое событие IConnectorEvents::OnUserPasswordChanged, и продолжается открытие конфигурации.

Генерация события IConnectorEvents::OnAfterOpenConfiguration

При успешном открытии конфигурации генерируется событие IConnectorEvents::OnAfterOpenConfiguration.